Skip to content

Update Time Tracker add-on docs for current UI and metadata - #30

Merged
bkatusic merged 2 commits into
mainfrom
docs-review/mainwp-time-tracker-extension
Apr 16, 2026
Merged

Update Time Tracker add-on docs for current UI and metadata#30
bkatusic merged 2 commits into
mainfrom
docs-review/mainwp-time-tracker-extension

Conversation

@bkatusic

@bkatusic bkatusic commented Apr 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • update the Time Tracker add-on metadata to the current purchase URL and version
  • align the page copy with current UI labels and navigation for buckets, settings, tasks, and actions
  • preserve the descriptive payment status and REST API context while adding the current v1/v2 API route details
  • clarify widget and table behavior for in-progress task counts

Testing

  • Not run (not requested)

Summary by CodeRabbit

  • Documentation
    • Updated REST API documentation with explicit v1 and v2 route versioning and comprehensive scope coverage for tasks, settings, clients, sites, and buckets
    • Improved Tasks column definition to clarify inclusion of both paused and working tasks in progress counts
    • Refined terminology and UI navigation paths throughout documentation for enhanced clarity

@mintlify

mintlify Bot commented Apr 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mainwp 🟢 Ready View Preview Apr 16, 2026, 5:49 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Apr 16, 2026

Copy link
Copy Markdown

Walkthrough

Updated add-on documentation for MainWP Time Tracker Extension, including version bump from 5.0 to 5.1.1, purchase URL path change, terminology alignment, UI navigation updates, and expanded REST API documentation with versioning details.

Changes

Cohort / File(s) Summary
Add-on Documentation Update
add-ons/client/mainwp-time-tracker-extension.mdx
Updated add-on metadata (purchase URL path and version number), refined terminology and UI navigation references, modified task action labels, restructured "Widgets and table information" section to describe Tasks column inclusion criteria, and expanded REST API documentation to explicitly cover route versioning (v1 and v2) with endpoint scope coverage for tasks, settings, clients, sites, and buckets.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly and concisely describes the main changes in the pull request: updating Time Tracker add-on documentation for UI alignment and metadata updates, which is the core purpose of the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs-review/mainwp-time-tracker-extension

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
add-ons/client/mainwp-time-tracker-extension.mdx (1)

104-116: Consider splitting dense action text for scanability.

Lines 104-116 are instruction-heavy and packed into long sentences. Breaking them into short bullets/steps would improve readability for users following the workflow.

🧭 Suggested structure
-![Time Tracker start a new task](/images/add-ons/time-tracker-start-task.gif) You can now dismiss the popup modal by clicking the X icon in the top right of the modal and continue with your work. When you are ready to **finish tracking** this task, navigate to the Time Tracker **Logs** page, locate the running task, and from the ellipsis menu, select **Continue**, then from the popup modal, select **Stop and Submit**. ![Complete time tracker task](/images/add-ons/time-tracker-working-task.png)
+![Time Tracker start a new task](/images/add-ons/time-tracker-start-task.gif)
+
+After starting the task, you can dismiss the modal with the **X** icon and continue working.
+
+To **finish tracking**:
+1. Navigate to **Time Tracker > Logs**.
+2. Locate the running task.
+3. Open the ellipsis menu and select **Continue**.
+4. In the modal, select **Stop and Submit**.
+
+![Complete time tracker task](/images/add-ons/time-tracker-working-task.png)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@add-ons/client/mainwp-time-tracker-extension.mdx` around lines 104 - 116,
Split the dense paragraphs in the "Finish tracking", "View Task details", "Edit
a Task", and "Delete a task" sections into short, numbered steps or bullet
points to improve scanability: for the "finish tracking" flow break the single
sentence into steps like navigate to Time Tracker Logs, locate the running task,
open the ellipsis menu, select Continue, then choose Stop and Submit; for "View
Task details" make a short bullet showing two ways to open details (click name
or ellipsis → View Detail) and list the information shown; for "Edit a Task"
list steps to open the edit modal and bullet the editable fields (including
Payment status and Task status); for "Delete a task" provide a concise two-step
action (open ellipsis → Delete, then confirm); ensure each header ("View Task
details", "Edit a Task", "Delete a task") contains its own short step list for
clarity.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@add-ons/client/mainwp-time-tracker-extension.mdx`:
- Around line 91-95: The lead-in phrase "To **initiate time tracking a task**"
is grammatically awkward; update that heading text to either "To initiate time
tracking for a task" or "To start tracking a task" and ensure the corresponding
markup around the Steps/Step block (the "To **initiate time tracking a task**"
string and any duplicated instances) is replaced so the Step title ("Click the
stopwatch icon, then select New Task to open the Time Tracker modal") remains
unchanged.

---

Nitpick comments:
In `@add-ons/client/mainwp-time-tracker-extension.mdx`:
- Around line 104-116: Split the dense paragraphs in the "Finish tracking",
"View Task details", "Edit a Task", and "Delete a task" sections into short,
numbered steps or bullet points to improve scanability: for the "finish
tracking" flow break the single sentence into steps like navigate to Time
Tracker Logs, locate the running task, open the ellipsis menu, select Continue,
then choose Stop and Submit; for "View Task details" make a short bullet showing
two ways to open details (click name or ellipsis → View Detail) and list the
information shown; for "Edit a Task" list steps to open the edit modal and
bullet the editable fields (including Payment status and Task status); for
"Delete a task" provide a concise two-step action (open ellipsis → Delete, then
confirm); ensure each header ("View Task details", "Edit a Task", "Delete a
task") contains its own short step list for clarity.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e19a38d8-0b72-4c3a-84f9-735c72996ce1

📥 Commits

Reviewing files that changed from the base of the PR and between 22f7f5e and 15ad9a4.

📒 Files selected for processing (1)
  • add-ons/client/mainwp-time-tracker-extension.mdx

Comment on lines +91 to +95
To **initiate time tracking a task**:

<Steps>
<Step title="Click on the Clock icon, then New Task menu entry to open the Time Tracker modal">
Click on the Clock icon, then **New Task** menu entry to open the Time Tracker modal
<Step title="Click the stopwatch icon, then select New Task to open the Time Tracker modal">
Click the stopwatch icon in the header actions, then select **New Task** to open the Time Tracker modal.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix grammar in the task-start lead-in.

Line 91 reads awkwardly (“initiate time tracking a task”). Suggest “initiate time tracking for a task” (or “start tracking a task”).

✏️ Proposed wording tweak
-To **initiate time tracking a task**:
+To **initiate time tracking for a task**:
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@add-ons/client/mainwp-time-tracker-extension.mdx` around lines 91 - 95, The
lead-in phrase "To **initiate time tracking a task**" is grammatically awkward;
update that heading text to either "To initiate time tracking for a task" or "To
start tracking a task" and ensure the corresponding markup around the Steps/Step
block (the "To **initiate time tracking a task**" string and any duplicated
instances) is replaced so the Step title ("Click the stopwatch icon, then select
New Task to open the Time Tracker modal") remains unchanged.

@bkatusic
bkatusic merged commit 5d3d044 into main Apr 16, 2026
4 checks passed
@bkatusic
bkatusic deleted the docs-review/mainwp-time-tracker-extension branch April 16, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant